matplotlib.pyplot.subplot | 您所在的位置:网站首页 › matplotlib web › matplotlib.pyplot.subplot |
Add an Axes to the current figure or retrieve an existing Axes. This is a wrapper of Figure.add_subplot which provides additional behavior when working with the implicit API (see the notes section). Call signatures: subplot(nrows, ncols, index, **kwargs) subplot(pos, **kwargs) subplot(**kwargs) subplot(ax) Parameters: *argsint, (int, int, index), or SubplotSpec, default: (1, 1, 1)The position of the subplot described by one of Three integers (nrows, ncols, index). The subplot will take the index position on a grid with nrows rows and ncols columns. index starts at 1 in the upper left corner and increases to the right. index can also be a two-tuple specifying the (first, last) indices (1-based, and including last) of the subplot, e.g., fig.add_subplot(3, 1, (1, 2)) makes a subplot that spans the upper 2/3 of the figure. A 3-digit integer. The digits are interpreted as if given separately as three single-digit integers, i.e. fig.add_subplot(235) is the same as fig.add_subplot(2, 3, 5). Note that this can only be used if there are no more than 9 subplots. A SubplotSpec. projection{None, 'aitoff', 'hammer', 'lambert', 'mollweide', 'polar', 'rectilinear', str}, optionalThe projection type of the subplot (Axes). str is the name of a custom projection, see projections. The default None results in a 'rectilinear' projection. polarbool, default: FalseIf True, equivalent to projection='polar'. sharex, shareyAxes, optionalShare the x or y axis with sharex and/or sharey. The axis will have the same limits, ticks, and scale as the axis of the shared Axes. labelstrA label for the returned Axes. Returns: AxesThe Axes of the subplot. The returned Axes can actually be an instance of a subclass, such as projections.polar.PolarAxes for polar projections. Other Parameters: **kwargsThis method also takes the keyword arguments for the returned Axes base class; except for the figure argument. The keyword arguments for the rectilinear base class Axes can be found in the following table but there might also be other keyword arguments if another projection is used. Property Description adjustable {'box', 'datalim'} agg_filter a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array and two offsets from the bottom left corner of the image alpha scalar or None anchor (float, float) or {'C', 'SW', 'S', 'SE', 'E', 'NE', ...} animated bool aspect {'auto', 'equal'} or float autoscale_on bool autoscalex_on unknown autoscaley_on unknown axes_locator Callable[[Axes, Renderer], Bbox] axisbelow bool or 'line' box_aspect float or None clip_box BboxBase or None clip_on bool clip_path Patch or (Path, Transform) or None facecolor or fc color figure Figure forward_navigation_events bool or "auto" frame_on bool gid str in_layout bool label object mouseover bool navigate bool navigate_mode unknown path_effects list of AbstractPathEffect picker None or bool or float or callable position [left, bottom, width, height] or Bbox prop_cycle Cycler rasterization_zorder float or None rasterized bool sketch_params (scale: float, length: float, randomness: float) snap bool or None subplotspec unknown title str transform Transform url str visible bool xbound (lower: float, upper: float) xlabel str xlim (left: float, right: float) xmargin float greater than -0.5 xscale unknown xticklabels unknown xticks unknown ybound (lower: float, upper: float) ylabel str ylim (bottom: float, top: float) ymargin float greater than -0.5 yscale unknown yticklabels unknown yticks unknown zorder float See also Figure.add_subplot pyplot.subplots pyplot.axes Figure.subplotsNotes Creating a new Axes will delete any preexisting Axes that overlaps with it beyond sharing a boundary: import matplotlib.pyplot as plt # plot a line, implicitly creating a subplot(111) plt.plot([1, 2, 3]) # now create a subplot which represents the top plot of a grid # with 2 rows and 1 column. Since this subplot will overlap the # first, the plot (and its Axes) previously created, will be removed plt.subplot(211)If you do not want this behavior, use the Figure.add_subplot method or the pyplot.axes function instead. If no kwargs are passed and there exists an Axes in the location specified by args then that Axes will be returned rather than a new Axes being created. If kwargs are passed and there exists an Axes in the location specified by args, the projection type is the same, and the kwargs match with the existing Axes, then the existing Axes is returned. Otherwise a new Axes is created with the specified parameters. We save a reference to the kwargs which we use for this comparison. If any of the values in kwargs are mutable we will not detect the case where they are mutated. In these cases we suggest using Figure.add_subplot and the explicit Axes API rather than the implicit pyplot API. Examples plt.subplot(221) # equivalent but more general ax1 = plt.subplot(2, 2, 1) # add a subplot with no frame ax2 = plt.subplot(222, frameon=False) # add a polar subplot plt.subplot(223, projection='polar') # add a red subplot that shares the x-axis with ax1 plt.subplot(224, sharex=ax1, facecolor='red') # delete ax2 from the figure plt.delaxes(ax2) # add ax2 to the figure again plt.subplot(ax2) # make the first Axes "current" again plt.subplot(221) |
今日新闻 |
推荐新闻 |
专题文章 |
CopyRight 2018-2019 实验室设备网 版权所有 |